% PAGAMIGO(1)
% Alyssa Rosenzweig
% July 2018

# Name

pagamigo - free software script to pay with PayPal

# Synopsis

pagamigo [options] username [--password password]

# Overview

Use an online shop and opt to pay with Paypal. You will be redirected to a URL
like:

	https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-CAFEBABE123456789

Copy that URL to your clipboard. Then, from the command line run:

	$ pagamigo USERNAME --url URL

Where URL is the URL you pasted from your browser, and username is from your
PayPal login credentials. You will be prompted for your password.

---

By default, this connects to the sandbox. For production (support
experimental), use:

	$ pagamigo USERNAME --url URL --base https://www.paypal.com

----

For peer-to-peer money transfer ("Send money"), don't pass a URL. Instead, pass
`recipient` and `amount` arguments, corresponding to the email address of the
recipient, and the amount of money to be transferred in USD as follows:

	$ pagamigo USERNAME --to EMAIL --amount AMOUNT

E.g. to transfer $1.23:

	$ pagamigo USERNAME --to example@example.org --amount 1.23

---

# Dependencies

Python (version 3) must be installed.

The following Python modules need to be installed: requests, lxml, cssselect.

The following external programs need to be installed: feh.

On Debian-based systems, these can be installed as:

	# apt install python3-requests python3-lxml python3-cssselect feh
